home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SCSL / ssum.z / ssum
Encoding:
Text File  |  2002-10-03  |  12.3 KB  |  265 lines
  1.  
  2.  
  3.  
  4. SSSSSSSSUUUUMMMM((((3333SSSS))))                                                              SSSSSSSSUUUUMMMM((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SSSSSSSSUUUUMMMM, DDDDSSSSUUUUMMMM, CCCCSSSSUUUUMMMM, ZZZZSSSSUUUUMMMM - Sums the elements of a real or complex vector
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      Single precision
  13.  
  14.           Fortran:
  15.                rrrreeeeaaaallll SSSSSSSSUUUUMMMM
  16.                rrrreeeeaaaallll _s_u_m
  17.                _s_u_m ==== SSSSSSSSUUUUMMMM ((((_n,,,, _x,,,, _i_n_c_x))))
  18.  
  19.           C/C++:
  20.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  21.                ffffllllooooaaaatttt ssssssssuuuummmm ((((iiiinnnntttt _n,,,, ffffllllooooaaaatttt *_x,,,, iiiinnnntttt _i_n_c_x))));;;;
  22.  
  23.      Double precision
  24.           Fortran:
  25.                ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn IIIIDDDDSSSSUUUUMMMM
  26.                ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn _s_u_m
  27.                _s_u_m ==== DDDDSSSSUUUUMMMM ((((_n,,,, _x,,,, _i_n_c_x))))
  28.  
  29.           CC++:
  30.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  31.                ddddoooouuuubbbblllleeee ddddssssuuuummmm ((((iiiinnnntttt _n,,,, ddddoooouuuubbbblllleeee *_x,,,, iiiinnnntttt _i_n_c_x))));;;;
  32.  
  33.      Single precision complex
  34.           Fortran:
  35.                ccccoooommmmpppplllleeeexxxx CCCCSSSSUUUUMMMM
  36.                ccccoooommmmpppplllleeeexxxx _s_u_m
  37.                _s_u_m ==== CCCCSSSSUUUUMMMM ((((_n,,,, _x,,,, _i_n_c_x))))
  38.  
  39.           C/C++:
  40.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  41.                ssssccccssssllll____ccccoooommmmpppplllleeeexxxx ccccssssuuuummmm ((((iiiinnnntttt _n,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt _i_n_c_x))));;;;
  42.  
  43.           C++ STL:
  44.                ####iiiinnnncccclllluuuuddddeeee <<<<ccccoooommmmpppplllleeeexxxx....hhhh>>>>
  45.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  46.                ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> ccccssssuuuummmm ((((iiiinnnntttt _n,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_x,,,, iiiinnnntttt _i_n_c_x))));;;;
  47.  
  48.      Double precision complex
  49.  
  50.           Fortran:
  51.                ddddoooouuuubbbblllleeee ccccoooommmmpppplllleeeexxxx ZZZZSSSSUUUUMMMM
  52.                ddddoooouuuubbbblllleeee ccccoooommmmpppplllleeeexxxx _s_u_m
  53.                _s_u_m ==== ZZZZSSSSUUUUMMMM ((((_n,,,, _x,,,, _i_n_c_x))))
  54.  
  55.           C/C++:
  56.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  57.                ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx zzzzssssuuuummmm ((((iiiinnnntttt _n,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt _i_n_c_x))));;;;
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSSSSSUUUUMMMM((((3333SSSS))))                                                              SSSSSSSSUUUUMMMM((((3333SSSS))))
  71.  
  72.  
  73.  
  74.           C++ STL:
  75.                ####iiiinnnncccclllluuuuddddeeee <<<<ccccoooommmmpppplllleeeexxxx....hhhh>>>>
  76.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  77.                ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>> zzzzssssuuuummmm ((((iiiinnnntttt _n,,,, ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>> *_x,,,, iiiinnnntttt _i_n_c_x);;;;
  78.  
  79. IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  80.      These routines are part of the SCSL Scientific Library and can be loaded
  81.      using either the ----llllssssccccssss or the ----llllssssccccssss____mmmmpppp option.  The ----llllssssccccssss____mmmmpppp option
  82.      directs the linker to use the multi-processor version of the library.
  83.  
  84.      When linking to SCSL with ----llllssssccccssss or ----llllssssccccssss____mmmmpppp, the default integer size is
  85.      4 bytes (32 bits). Another version of SCSL is available in which integers
  86.      are 8 bytes (64 bits).  This version allows the user access to larger
  87.      memory sizes and helps when porting legacy Cray codes.  It can be loaded
  88.      by using the ----llllssssccccssss____iiii8888 option or the ----llllssssccccssss____iiii8888____mmmmpppp option. A program may use
  89.      only one of the two versions; 4-byte integer and 8-byte integer library
  90.      calls cannot be mixed.
  91.  
  92.      The C and C++ prototypes shown above are appropriate for the 4-byte
  93.      integer version of SCSL. When using the 8-byte integer version, the
  94.      variables of type iiiinnnntttt become lllloooonnnngggg lllloooonnnngggg and the <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>> header file
  95.      should be included.
  96.  
  97. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  98.      SSSSSSSSUUUUMMMM/DDDDSSSSUUUUMMMM sums the elements of a real vector.
  99.  
  100.      CCCCSSSSUUUUMMMM/ZZZZSSSSUUUUMMMM sums the elements of a complex vector.
  101.  
  102.      These routines perform the following vector operation:
  103.  
  104.                   n
  105.           sum <- Sum  x
  106.                  i=1   i
  107.  
  108.  
  109.      These routines have the following arguments:
  110.  
  111.      _s_u_m       Sum of the elements of the vector _x.  If _n <= 0, _s_u_m is set to
  112.                0. (input)
  113.                SSSSSSSSUUUUMMMM: Single precision sum.
  114.                DDDDSSSSUUUUMMMM: Double precision sum.
  115.                CCCCSSSSUUUUMMMM: Single precision complex sum.
  116.                ZZZZSSSSUUUUMMMM: Double precision complex sum.
  117.  
  118.      _n         Integer.  (input)
  119.                Number of vector elements to be summed.
  120.  
  121.      _x         Array of dimension (_n-1) * |_i_n_c_x| + 1.  (input)
  122.                SSSSSSSSUUUUMMMM: Single precision array.
  123.                DDDDSSSSUUUUMMMM: Double precision array.
  124.                CCCCSSSSUUUUMMMM: Single precision complex array.
  125.                ZZZZSSSSUUUUMMMM: Double precision complex array.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSSSSSUUUUMMMM((((3333SSSS))))                                                              SSSSSSSSUUUUMMMM((((3333SSSS))))
  137.  
  138.  
  139.  
  140.                Vector that contains elements to be summed.
  141.  
  142.      _i_n_c_x      Integer.  (input)
  143.                Increment between elements of _x.  If _i_n_c_x = 0, the results will
  144.                be unpredictable.
  145.  
  146. NNNNOOOOTTTTEEEESSSS
  147.      These routines are extensions to the standard Level 1 Basic Linear
  148.      Algebra Subprograms (Level 1 BLAS).
  149.  
  150.      When working backward (_i_n_c_x < 0), each routine starts at the end of the
  151.      vector and moves backward, as follows:
  152.  
  153.      Fortran:
  154.  
  155.           x(1 - incx * (n-1)), x(1 - incx * (n-2)), ..., x(1)
  156.  
  157.  
  158.      C/C++:
  159.  
  160.           x[-incx * (n-1)], x[-incx * (n-2)], ..., x[0]
  161.  
  162.  
  163.    DDDDaaaattttaaaa TTTTyyyyppppeeeessss
  164.      The following data types are described in this documentation:
  165.  
  166.           TTTTeeeerrrrmmmm UUUUsssseeeedddd                     DDDDaaaattttaaaa ttttyyyyppppeeee
  167.  
  168.      Fortran:
  169.  
  170.           Array dimensioned _n           xxxx((((nnnn))))
  171.  
  172.           Integer                       IIIINNNNTTTTEEEEGGGGEEEERRRR (IIIINNNNTTTTEEEEGGGGEEEERRRR****8888 for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  173.  
  174.           Single precision              RRRREEEEAAAALLLL
  175.  
  176.           Double precision              DDDDOOOOUUUUBBBBLLLLEEEE PPPPRRRREEEECCCCIIIISSSSIIIIOOOONNNN
  177.  
  178.           Single precision complex      CCCCOOOOMMMMPPPPLLLLEEEEXXXX
  179.  
  180.           Double precision complex      DDDDOOOOUUUUBBBBLLLLEEEE CCCCOOOOMMMMPPPPLLLLEEEEXXXX
  181.  
  182.      C/C++:
  183.  
  184.           Array dimensioned _n           xxxx[[[[_n]]]]
  185.  
  186.           Integer                       iiiinnnntttt (lllloooonnnngggg lllloooonnnngggg for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  187.  
  188.           Single precision              ffffllllooooaaaatttt
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. SSSSSSSSUUUUMMMM((((3333SSSS))))                                                              SSSSSSSSUUUUMMMM((((3333SSSS))))
  203.  
  204.  
  205.  
  206.           Double precision              ddddoooouuuubbbblllleeee
  207.  
  208.           Single precision complex      ssssccccssssllll____ccccoooommmmpppplllleeeexxxx
  209.  
  210.           Double precision complex      ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx
  211.  
  212.      C++ STL:
  213.  
  214.           Array dimensioned _n           xxxx[[[[_n]]]]
  215.  
  216.           Integer                       iiiinnnntttt (lllloooonnnngggg lllloooonnnngggg for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  217.  
  218.           Single precision              ffffllllooooaaaatttt
  219.  
  220.           Double precision              ddddoooouuuubbbblllleeee
  221.  
  222.           Single precision complex      ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>>
  223.  
  224.           Double precision complex      ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>>
  225.  
  226. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  227.      IIIINNNNTTTTRRRROOOO____SSSSCCCCSSSSLLLL(3S), IIIINNNNTTTTRRRROOOO____BBBBLLLLAAAASSSS1111(3S)
  228.  
  229.      IIIINNNNTTTTRRRROOOO____CCCCBBBBLLLLAAAASSSS(3S) for information about using the C interface to Fortran 77
  230.      Basic Linear Algebra Subprograms (legacy BLAS) set forth by the Basic
  231.      Linear Algebra Subprograms Technical Forum.
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.                                                                         PPPPaaaaggggeeee 4444
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.